Move documentation to inline comments: Testing utilities

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 1f9678b71738b62b6833e3288ae21ce45cc365eb..b6d9f7a12e5d332d8a465113900a9ef1fad7847c 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -1 +1,2 @@
 gtkmessagedialog.sgml
+gtktesting.sgml

diff --git a/docs/reference/gtk/tmpl/gtktesting.sgml b/docs/reference/gtk/tmpl/gtktesting.sgml
deleted file mode 100644 (file)
index bcbc3d7..0000000
--- a/docs/reference/gtk/tmpl/gtktesting.sgml
+++ /dev/null
@@ -1,177 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Testing
-
-<!-- ##### SECTION Short_Description ##### -->
-Utilities for testing GTK+ applications
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### FUNCTION gtk_test_create_simple_window ##### -->
-<para>
-
-</para>
-
-@window_title: 
-@dialog_text: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_create_widget ##### -->
-<para>
-
-</para>
-
-@widget_type: 
-@first_property_name: 
-@Varargs: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_display_button_window ##### -->
-<para>
-
-</para>
-
-@window_title: 
-@dialog_text: 
-@Varargs: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_find_label ##### -->
-<para>
-
-</para>
-
-@widget: 
-@label_pattern: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_find_sibling ##### -->
-<para>
-
-</para>
-
-@base_widget: 
-@widget_type: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_find_widget ##### -->
-<para>
-
-</para>
-
-@widget: 
-@label_pattern: 
-@widget_type: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_init ##### -->
-<para>
-
-</para>
-
-@argcp: 
-@argvp: 
-@Varargs: 
-
-
-<!-- ##### FUNCTION gtk_test_list_all_types ##### -->
-<para>
-
-</para>
-
-@n_types: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_register_all_types ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### FUNCTION gtk_test_slider_get_value ##### -->
-<para>
-
-</para>
-
-@widget: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_slider_set_perc ##### -->
-<para>
-
-</para>
-
-@widget: 
-@percentage: 
-
-
-<!-- ##### FUNCTION gtk_test_spin_button_click ##### -->
-<para>
-
-</para>
-
-@spinner: 
-@button: 
-@upwards: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_text_get ##### -->
-<para>
-
-</para>
-
-@widget: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_text_set ##### -->
-<para>
-
-</para>
-
-@widget: 
-@string: 
-
-
-<!-- ##### FUNCTION gtk_test_widget_click ##### -->
-<para>
-
-</para>
-
-@widget: 
-@button: 
-@modifiers: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_test_widget_send_key ##### -->
-<para>
-
-</para>
-
-@widget: 
-@keyval: 
-@modifiers: 
-@Returns: 
-
-

diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c
index a60cdcf651bf5c2000bd65350a916e045ff656d8..5ea2d1dffc6b9ae78c8947c0f6a340d2f079d654 100644 (file)
--- a/gtk/gtktestutils.c
+++ b/gtk/gtktestutils.c
@@ -34,7 +34,12 @@
 #include <math.h>
 
 
-/* --- test utilities --- */
+/**
+ * SECTION:gtktesting
+ * @Short_description: Utilities for testing GTK+ applications
+ * @Title: Testing
+ */
+
 /**
  * gtk_test_init:
  * @argcp: Address of the <parameter>argc</parameter> parameter of the